home *** CD-ROM | disk | FTP | other *** search
- DOKUMENTATION LIB
-
- **** Ein GST (.bin) Library-Manager.*************
-
-
- (C) 1988/89 Olaf Flebbe
- Südliche Stadtmauerstr. 66
- 8520 Erlangen
-
-
- Zuerst eine Bitte:
- Wenn Ihnen dieses Programm gefällt, senden Sie mir bitte
- 20DM als Anerkennung an obige Addresse.! Ich denke, dieses
- Programm ist es wert.
- (Bitte V-Scheck oder Schein).
-
-
- LIB ist ein Library-Manager für GST-Object-Files. Mangels
- anderer Software, die dieses Format unterstützt, ist er nur
- mit dem LATTICE-C Compiler V3.04 getestet worden. Wenn also
- Ihr Compiler einen Code liefert, der zusätzliche Features
- unterstützt, setzen Sie sich mit mir in Verbindung. Ich
- werde versuchen, die zusätzlichen OPCODES zu
- implementieren. Auch sind Anregungen und BUG-Reports
- erwünscht. ABER: Dieses Programm wird nie eine
- GEM-Oberfläche erhalten! (Ist mir einfach viel zu viel
- Arbeit.)
-
- WARNUNG: Die Option -d des LC1.TTP wird nicht (!)
- unterstützt, aus dem einfachen Grund, da diese nicht
- richtig zu funktionieren scheint.
-
-
- Bedienung:
- Der Aufruf des Library-Managers lautet:
- lib [>output] [optionen] <libfile>.
-
-
- KOMMENTAR:Im folgenden ist <file> der Name einer Datei, in
- dem die Namen der Module jedes auf einer Zeile angegeben
- ist. Jedes Modul hat eine Kennung. Wenn der Filename eines
- externen Moduls nicht mit dem Modulnamen übereinstimmt,
- setzt es eine Warnung! Beim Lesen und Schreiben von Modulen
- wird stets ein '.bin' als Dateiendung angenommen! Auch dem
- Libfile wird ein '.bin' angehängt. Mit >output kann die
- Ausgabe des Managers in ein File (oder Drucker...)
- umgelenkt werden.
-
- Es ist genau eine der folgenden Optionen anzugeben:
-
- (keine) :(none) listet alle Module in 'libfile'.
- -a<file>:(append) hänge die Module an libfile an.
- -b<file>:(build) erzeuge Library aus Modulen,
- -c<file>:(change) tausche Module aus.
- -d<file>:(delete) lösche Module in Library.
- -i<file>:(info) liste Referenzen.
- -s<file>:(show) liste Namen der Modulle
- -t :(test) teste Library auf Konsistenz.
- -x<file>:(extract) kopiere Module aus Library.
-
- -o<path>:Gebe Pfad für die externen Module bei Optionen
- -a,-b,-c,-x an.
-
- KOMMENTAR zu den einzelnen Funktionen:
- 'Append' kann nur an eine bestehende LIBRARY etwas anfügen.
- Um eine LIBRARY zu erzeugen, verweden Sie bitte 'Build'.
-
- 'Info' listet die definierten Symbole und die
- referenzierten Symbole auf: In der ersten Spalte steht der
- Modulname, in der zweiten Spalte die referenzierten und in
- der letzten die definierten Symbole. Der LATTICE Compiler
- erzeugt in jedem Modul Referenzen auf: text (TEXT-SEGMENT),
- data (DATA-SEGMENT), udata (BSS-SEGMENT). Idiotischerweise
- legt der Linker von GST alle drei Segmente in das
- TEXTSEGMENT!
-
- 'Test' untersucht die Library nun darauf, ob alle Symbole,
- auf die sich ein Modul bezieht, nachher definiert werden.
- Wenn dies so ist, kann die Bibliothek dann vom Linker in
- einem Aufwasch verarbeitet werden. Die Referenzen 'text,
- 'data' und 'udata' werden natürlich erst vom Linker
- gesetzt, und geben daher ein Meldung.
-
- Warnung: Es wird zwischenzeitlich ein FILE libname.$$$
- erzeugt! Stellen Sie also sicher, daß genügend Platz auf
- dem Standartlaufwerk ist. Es ist möglich, sich mit 'delete'
- seine Library zu zerstören! Also bitte immer nur auf
- Sicherungskopien anwenden!
-
- Ich hoffe, jetzt ist alles klar.
-
- Viel Spaß!
-
-